Change Request Time Entry Service

Dieser Service definiert alle Methoden, um mit Änderungsanträgen von Zeiteinträgen in TimePunch zu arbeiten.
Er wird verwendet, um beantragte Änderungen zu suchen, zu prüfen, zu genehmigen oder abzulehnen.

---

GetChangeRequestCountAndDate

Gibt die Anzahl der Änderungsanträge sowie das Datum des letzten Änderungsantrags zurück.

Tuple<int, DateTime> GetChangeRequestCountAndDate(
    out TpFault fault,
    TpAuthentication authentication,
    ChangeRequestTimeEntrySearchDto searchDto);

Needed Permission	changeRequests@access
fault	Out	Enthält den Fehler, falls eine Ausnahme auftritt.
authentication		Authentifizierungsobjekt mit den Benutzeranmeldeinformationen.
searchDto		Suchkriterien für Änderungsanträge.

---

SearchChangeRequestTimeEntries

Sucht Änderungsanträge, die den angegebenen Suchkriterien entsprechen.

List<ChangeRequestTimeEntryDto> SearchChangeRequestTimeEntries(
    out TpFault fault,
    TpAuthentication authentication,
    ChangeRequestTimeEntrySearchDto searchDto);

Needed Permission	changeRequests@access
fault	Out	Enthält den Fehler, falls eine Ausnahme auftritt.
authentication		Benutzer-Authentifizierung.
searchDto		Enthält die Suchparameter für Änderungsanträge.

---

GetAllChangeRequestsByApprover

Liest alle Änderungsanträge aus, die einem bestimmten Genehmigenden zugewiesen sind.

List<ChangeRequestTimeEntryDto> GetAllChangeRequestsByApprover(
    out TpFault fault,
    TpAuthentication authentication,
    Guid approverId);

Needed Permission	changeRequests@access
fault	Out	Enthält den Fehler, falls eine Ausnahme auftritt.
authentication		Authentifizierungsdaten des Benutzers.
approverId		Die ID des Genehmigenden.

---

DeleteChangeRequestTimeEntries

Löscht Änderungsanträge anhand einer Liste von Zeitbuchungs-IDs.

void DeleteChangeRequestTimeEntries(
    out TpFault fault,
    TpAuthentication authentication,
    List<Guid> entryIds);

Needed Permission	changeRequests@access
fault	Out	Enthält den Fehler, falls eine Ausnahme auftritt.
authentication		Authentifizierungsobjekt.
entryIds		Liste der IDs der Änderungsanträge, die gelöscht werden sollen.

---

DeclineChangeRequestTimeEntry

Lehnt einen Änderungsantrag ab.

void DeclineChangeRequestTimeEntry(
    out TpFault fault,
    TpAuthentication authentication,
    Guid crTimeEntryId,
    string declineReason);

Needed Permission	changeRequests@manage
fault	Out	Enthält den Fehler, falls eine Ausnahme auftritt.
authentication		Authentifizierungsobjekt.
crTimeEntryId		ID des Änderungsantrags, der abgelehnt werden soll.
declineReason		Begründung der Ablehnung.

---

ApplyChangeRequestTimeEntry

Übernimmt einen genehmigten Änderungsantrag und wendet ihn auf den Zeiteintrag an.

TimeEntryDto ApplyChangeRequestTimeEntry(
    out TpFault fault,
    TpAuthentication authentication,
    Guid crTimeEntryId);

Needed Permission	changeRequests@manage
fault	Out	Enthält den Fehler, falls eine Ausnahme auftritt.
authentication		Authentifizierungsdaten.
crTimeEntryId		ID des Änderungsantrags, der übernommen werden soll.

---

SaveChangeRequestTimeEntry

Validiert und speichert einen Änderungsantrag zu einem Zeiteintrag.

ChangeRequestTimeEntryDto SaveChangeRequestTimeEntry(
    out TpFault fault,
    TpAuthentication authentication,
    ChangeRequestTimeEntryDto crTimeEntry,
    List<CustomFieldContentDto> customFieldContents);

Needed Permission	changeRequests@access
fault	Out	Enthält den Fehler, falls eine Ausnahme auftritt.
authentication		Authentifizierungsobjekt.
crTimeEntry		Der Änderungsantrag, der validiert und gespeichert werden soll.
customFieldContents		Liste der benutzerdefinierten Felder des Zeiteintrags.

---

GetChangeRequestTimeEntry

Liest einen vorhandenen Änderungsantrag anhand seiner ID aus.

ChangeRequestTimeEntryDto GetChangeRequestTimeEntry(
    out TpFault fault,
    TpAuthentication authentication,
    Guid crTimeEntryId);

Needed Permission	changeRequests@access
fault	Out	Enthält den Fehler, falls eine Ausnahme auftritt.
authentication		Benutzer-Authentifizierung.
crTimeEntryId		ID des Änderungsantrags.

---

GetChangeRequestApprover

Liest die Genehmigenden (Approver) für bestimmte Benutzer-IDs aus.

List<ChangeRequestApproverDto> GetChangeRequestApprover(
    out TpFault fault,
    TpAuthentication authentication,
    List<Guid> userIds);

Needed Permission	changeRequests@access
fault	Out	Enthält den Fehler, falls eine Ausnahme auftritt.
authentication		Authentifizierungsobjekt.
userIds		Liste der Benutzer-IDs, für die die Genehmigenden abgefragt werden.

---

SetChangeRequestApprover

Setzt oder aktualisiert den Genehmigenden (Approver) für Änderungsanträge.

void SetChangeRequestApprover(
    out TpFault fault,
    TpAuthentication authentication,
    ChangeRequestApproverDto approver);

Needed Permission	changeRequests@admim
fault	Out	Enthält den Fehler, falls eine Ausnahme auftritt.
authentication		Authentifizierungsdaten.
approver		Der festzulegende Genehmigende.

---

DeleteChangeRequestApprover

Löscht den Genehmigenden eines bestimmten Benutzers.

void DeleteChangeRequestApprover(
    out TpFault fault,
    TpAuthentication authentication,
    Guid userId);

Needed Permission	changeRequests@admim
fault	Out	Enthält den Fehler, falls eine Ausnahme auftritt.
authentication		Benutzer-Authentifizierung.
userId		Benutzer-ID, deren Genehmigender gelöscht werden soll.